home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / base / usrguide.tex / node15_mn.html < prev    next >
Text File  |  1995-03-15  |  2KB  |  39 lines
  1.  
  2. <H2><A ID="SECTION00041000000000000000">
  3. Initial commands</A>
  4. </H2>
  5.  
  6. Initial commands can appear only before the |
  7. line.
  8.  
  9. <BR>
  10. <tex2html_image_mark>#decl182#
  11. <BR>
  12.  
  13. The |filecontents| environment is intended for bundling within a
  14. single document file the contents of packages, options, or other
  15. files.  When the document file is run through L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X2<SUB>e</SUB><#188#><#188#> the body of
  16. this environment is written verbatim (preceded by a comment line) to a
  17. file whose name is given as the environment's only argument.  However,
  18. if that file already exists then nothing happens except for an
  19. information message.
  20.  
  21. Only normal ASCII text characters (i.e.~7-bit visible text) should be
  22. included in a |filecontents| environment.  Anything else, such as tab
  23. characters, form-feeds or 8-bit characters, should not be included in a
  24. |filecontents| environment.
  25.  
  26. Tabs and form feeds produce a warning, explaining that they are turned
  27. into spaces or blank lines, respectively.
  28. What happens to 8-bit characters depends on the T<SMALL>E</SMALL>X<#189#><#189#> installation and
  29. is in general unpredictable.
  30.  
  31. The |filecontents| environment is used for including L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X<#190#><#190#> files.
  32. For other plain text files (such as Encapsulated PostScript files),
  33. you should use the |filecontents*| environment which does not add a
  34. comment line.
  35.  
  36. These environments are allowed only before |.  This
  37. ensures that any packages that have been bundled in the document are
  38. present when needed.
  39.